GermanWikipedia - /page/entry.mu

Micron Document

<!DOCTYPE html>

<title>Java-Properties-Datei</title>

</head>

<h1 id="firstHeading" class="firstHeading mw-first-heading">Java-Properties-Datei</h1>

</header>

</div>

<div id="mw-content-text" class="mw-body-content mw-content-ltr" lang="de" dir="ltr"><div class="mw-content-ltr mw-parser-output" lang="de" dir="ltr">Eine Java-Properties-Datei ist eine <a href="Konfigurationsdatei" title="Konfigurationsdatei">Konfigurationsdatei</a>, die hauptsächlich zur Speicherung von Anwendungsdaten im Umfeld der Programmiersprache <a href="Java_(Programmiersprache)" title="Java (Programmiersprache)">Java</a> verwendet wird. Eine Property (deutsch „Eigenschaft“) ist in diesem Zusammenhang ein Text, der unter einem bestimmten Namen abgelegt ist. Java-Properties-Dateien haben üblicherweise die <a href="Dateiendung" class="mw-redirect" title="Dateiendung">Dateiendung</a> <code>.properties</code>.

<div class="mw-heading mw-heading2"><h2 id="Struktur">Struktur</h2></div>

Das folgende Beispiel zeigt einen Ausschnitt aus einer einfachen Konfigurationsdatei:

<div class="mw-highlight mw-highlight-lang-properties mw-content-ltr" dir="ltr"><pre># Dies ist ein Kommentar

! Dies ist ebenfalls ein Kommentar

wenig Text

pi = 3.14

lang:de

vieltext Dieser Text \

läuft über zwei Zeilen.

paramText = Text mit dynamischem Parameter: {0}

unicodeText = Ein Smiley: \u263A

</pre></div>

Das Beispiel enthält zwei <a href="Kommentar_(Programmierung)" title="Kommentar (Programmierung)">Kommentarzeilen</a> und definiert sechs Werte für die Namen <code>wenig</code>, <code>pi</code>, <code>lang</code>, <code>vieltext</code>, <code>paramText</code> und <code>unicodeText</code>.

Wie sich aus dem Beispiel erkennen lässt, gibt es Kommentarzeilen, die mit einem <a href="Rautezeichen" title="Rautezeichen">Rautezeichen</a> <code>#</code> oder einem <a href="Ausrufezeichen" title="Ausrufezeichen">Ausrufezeichen</a> <code>!</code> beginnen, und Datenzeilen, in denen ein Name und ein Text definiert werden.<a href="#cite_note-store-1">[1]</a>

Name und Text können auf drei Arten voneinander getrennt werden, wobei die Trennzeichen nicht zum Schlüssel oder Text gehören.<a href="#cite_note-store-1">[1]</a>

<ol><li>durch ein oder mehrere <a href="Leerzeichen" title="Leerzeichen">Leerzeichen</a>: Im obigen Beispiel hat der Schlüssel <code>wenig</code> den Wert „Text“, entsprechend <code>vieltext</code>.</li>

<li>durch ein <a href="Gleichheitszeichen" title="Gleichheitszeichen">Gleichheitszeichen</a> <code>=</code>, umgeben von keinem oder beliebig vielen Leerzeichen: Im obigen Beispiel hat der Schlüssel <code>pi</code> den Wert „3.14“.</li>

<li>durch einen <a href="Doppelpunkt" title="Doppelpunkt">Doppelpunkt</a> <code>:</code>, umgeben von keinem oder beliebig vielen Leerzeichen: Im obigen Beispiel hat der Schlüssel <code>lang</code> den Wert „de“.</li></ol>

Ein <a href="Umgekehrter_Schr%C3%A4gstrich" class="mw-redirect" title="Umgekehrter Schrägstrich">umgekehrter Schrägstrich</a> <code>\</code> am Ende der Zeile bedeutet, dass der Text in der nächsten Zeile fortgesetzt wird.<a href="#cite_note-store-1">[1]</a> Stehen am Ende der Zeile mehrere umgekehrte Schrägstriche, wird der Text nur dann in der nächsten Zeile fortgesetzt, wenn die Anzahl der Schrägstriche ungerade ist. Endet die Zeile z. B. auf <code>\\</code>, so reicht der Text nur bis zum Ende der Zeile und enthält am Ende einen umgekehrten Schrägstrich; endet die Zeile hingegen auf <code>\\\</code>, dann wird der Text in der nächsten Zeile fortgesetzt.<a href="#cite_note-store-1">[1]</a>

Als Zeichencodierung für den Text wird <a href="ISO_8859-1" title="ISO 8859-1">ISO 8859-1</a> verwendet. Unicode-Zeichen, die nicht im ISO-Encoding enthalten sind, müssen mit einer <a href="Escape-Sequenz" title="Escape-Sequenz">Escape-Sequenz</a> codiert werden.<a href="#cite_note-store-1">[1]</a>

<div class="mw-heading mw-heading2"><h2 id="Verwendung_in_Java-Programmen">Verwendung in Java-Programmen</h2></div>

Eine solche Java-Properties-Datei kann mittels der <a href="Klasse_(Objektorientierung)" title="Klasse (Objektorientierung)">Klasse</a> <code><a rel="nofollow" class="external text" href="https://docs.oracle.com/javase/8/docs/api/java/util/Properties.html">java.util.Properties</a></code> eingelesen werden. Anschließend können die definierten Werte über deren <a href="Methode_(Programmierung)" title="Methode (Programmierung)">Methoden</a> abgefragt werden. Das folgende Code-Fragment erzeugt ein Properties-Objekt, liest eine Datei namens <code>beispiel.properties</code> ein, und legt den Wert der Property <code>lang</code> in einer Variablen namens <code>sprache</code> ab.

<div class="mw-highlight mw-highlight-lang-java mw-content-ltr" dir="ltr"><pre>import java.io.FileInputStream;

import java.io.BufferedInputStream;

import java.util.Properties;

…

Properties properties = new Properties();

BufferedInputStream stream = new BufferedInputStream(new FileInputStream("beispiel.properties"));

properties.load(stream);

stream.close();

String sprache = properties.getProperty("lang");

</pre></div>

Bei der <code>load</code>-Methode muss die <a href="Ausnahmebehandlung" title="Ausnahmebehandlung">Ausnahme</a> <code><a rel="nofollow" class="external text" href="https://docs.oracle.com/javase/8/docs/api/java/io/IOException.html">IOException</a></code> abgefangen werden. Der Übersicht wegen wurde der Try-Catch-Block weggelassen.

<div class="mw-heading mw-heading2"><h2 id="Platzhalter">Platzhalter</h2></div>

Eine <a href="Positive_und_negative_Zahlen" title="Positive und negative Zahlen">nicht negative</a> <a href="Ganze_Zahl" title="Ganze Zahl">ganze Zahl</a> in geschweiften Klammern <code>{}</code> steht für einen Text, der zur <a href="Laufzeit_(Informatik)" title="Laufzeit (Informatik)">Laufzeit</a> des Programms ergänzt werden soll. Sinnvollerweise beginnen die Zahlen in den Klammern mit <code>0</code> und sind fortlaufend. Sie dürfen mehrfach sowie in beliebiger <a href="Reihenfolge" title="Reihenfolge">Reihenfolge</a> auftreten. Solche Ersetzungen sind für die <a href="Internationalisierung_(Softwareentwicklung)" title="Internationalisierung (Softwareentwicklung)">Internationalisierung</a> oder <a href="Lokalisierung_(Softwareentwicklung)" title="Lokalisierung (Softwareentwicklung)">Lokalisierung</a> von Programmen sinnvoll, wo dynamisch zu erzeugende Textbestandteile in unterschiedlichen <a href="Sprache" title="Sprache">Sprachen</a> an unterschiedlichen Stellen oder in unterschiedlicher Reihenfolge auszugeben sind.

Die Ersetzung des Parameters kann mit folgendem Code realisiert werden:

<div class="mw-highlight mw-highlight-lang-java mw-content-ltr" dir="ltr"><pre>String paramText = properties.getProperty("paramText");

String dynText = "dynamisch eingesetzter Text";

System.out.println(MessageFormat.format(paramText,dynText));

</pre></div>

Ausgabe:

<pre>Text mit dynamischem Parameter: dynamisch eingesetzter Text

</pre>

Bei mehreren Ersetzungsparametern muss für „dynText“ ein <a href="Array_(Datentyp)" title="Array (Datentyp)">Array</a> oder eine <a href="Menge_(Datenstruktur)" title="Menge (Datenstruktur)">Menge</a> mit den Ersetzungswerten übergeben werden.

Streng genommen ist dies kein Feature des Properties-Mechanismus, wird hier jedoch erwähnt, da es in diesem Zusammenhang vielfach Verwendung findet.

<div class="mw-heading mw-heading2"><h2 id="Internationalisierung">Internationalisierung</h2></div>

Ein weiteres Feature des Properties-Mechanismus in Java ist das Aufteilen der Inhalte pro <a href="Locale" title="Locale">Locale</a>. Das macht man durch ein Suffix im Dateinamen kenntlich. Eine Properties-Datei <code>messages.properties</code> speziell für deutschsprachige Texte würde man <code>messages_de.properties</code> benennen. Das kann man mit der Angabe einer Region noch weiter eingrenzen. Eine Property-Datei für österreichisches Deutsch würde demnach so benannt: <code>messages_de_AT.properties</code>. Eine Variante ohne Suffix sollte als Fallback möglichst immer vorhanden sein. Seit Java 9 werden ResourceBundles-Properties standardmäßig mit UTF-8 decodiert, wodurch die unleserlichen Escape-Sequenzen entfallen können. Sollten beim Dekodieren Probleme auftreten, wird es mit ISO 8859-1 automatisch erneut versucht.<a href="#cite_note-2">[2]</a>

<div class="mw-heading mw-heading2"><h2 id="Einzelnachweise">Einzelnachweise</h2></div>

<li id="cite_note-store-1">↑ <a href="#cite_ref-store_1-0">a</a> <a href="#cite_ref-store_1-1">b</a> <a href="#cite_ref-store_1-2">c</a> <a href="#cite_ref-store_1-3">d</a> <a href="#cite_ref-store_1-4">e</a> <a rel="nofollow" class="external text" href="https://docs.oracle.com/javase/7/docs/api/java/util/Properties.html">Properties.</a> Java API Specification

</li>

<li id="cite_note-2"><a href="#cite_ref-2">↑</a> <a rel="nofollow" class="external text" href="https://openjdk.java.net/jeps/226">JEP 226: UTF-8 Property Resource Bundles.</a> Abgerufen am 22. Juni 2020.<span style="display: none;" class="Z3988" title="ctx_ver=Z39.88-2004&rft_val_fmt=info%3Aofi%2Ffmt%3Akev%3Amtx%3Adc&rfr_id=info%3Asid%2Fde.wikipedia.org%3AJava-Properties-Datei&rft.title=JEP+226%3A+UTF-8+Property+Resource+Bundles&rft.description=JEP+226%3A+UTF-8+Property+Resource+Bundles&rft.identifier=https%3A%2F%2Fopenjdk.java.net%2Fjeps%2F226">

</li>

</ol></div><div><div class="zim-footer">

Dieser Artikel wurde von <a class="external text" title="Zuletzt bearbeitet am 2024-10-14" href="https://de.wikipedia.org/wiki/?title=Java-Properties-Datei&oldid=249414150">Wikipedia</a> herausgegeben. Der Text ist unter <a class="external text" href="https://creativecommons.org/licenses/by-sa/4.0/deed.de">Creative Commons Attribution-Share Alike 4.0</a> verfügbar, sofern nicht anders angegeben. Für die Mediendateien können zusätzliche Bedingungen gelten.

</div>

</div></div>

</div>

</main>

</div>

</body></html>